
package com.intretech.umsin.system.service;


import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.intretech.umsin.common.entity.DictModel;
import com.intretech.umsin.system.entity.SysDictItemEntity;
import com.intretech.umsin.system.param.SysDictItemParam;
import com.intretech.umsin.system.vo.SysDictItemVo;

import java.io.Serializable;
import java.util.Collection;
import java.util.List;


/**
* @version V1.0
* 系统字典详情信息:sys_dict_item 对应商业服务接口.
* @InterfaceName: SysDictItemService
* @Description: 系统字典详情信息:sys_dict_item 对应商业服务接口.
* @author: 李启联
* @date:   2022-8-6 14:37:22
* @Copyright: Copyright (c) 2022
*/
public interface SysDictItemService extends IService<SysDictItemEntity> {

    /**
    * 根据ID查询单个系统字典详情信息对象
    * @param id 组键ID
    * @return 单个系统字典详情信息VO对象
    */
    SysDictItemVo queryById(Serializable id);


    /**
    * 根据ID集合查询返回系统字典详情信息列表
    * @param idList 组键ID集合
    * @return 系统字典详情信息列表
    */
    List<SysDictItemVo> queryByIds(Collection<? extends Serializable> idList);

    /**
    * 分页查询 系统字典详情信息 信息
    * @param page 分页对象
    * @param param 查询参数
    * @return IPage<SysDictItemVo> 分页对象
    */
    IPage<SysDictItemVo> queryForPage(IPage page,SysDictItemParam param);

    /**
    * 根据条件查询返回 系统字典详情信息 对象列表
    * @param  param 查询参数
    * @return 系统字典详情信息 对象列表
    */
    List<SysDictItemVo> queryForList(SysDictItemParam param);

    /**
    * 添加系统字典详情信息到数据库
    * @param vo  系统字典详情信息 VO对象
    * @return 添加后的系统字典详情信息 VO对象
    */
    SysDictItemVo add(SysDictItemVo vo);

    /**
    * 添加系统字典详情信息集合列表到数据库
    * @param vos  系统字典详情信息 VO对象列表
    * @return 添加后的系统字典详情信息 VO对象集合列表
    */
    List<SysDictItemVo> adds(List<SysDictItemVo> vos);

    /**
    * 更新系统字典详情信息到数据库
    * @param vo 要更新的系统字典详情信息 VO对象
    * @return 更新后的系统字典详情信息 VO对象
    */
    SysDictItemVo modify(SysDictItemVo vo);

    /**
    * 更新系统字典详情信息集合列表到数据库
    * @param vos 要更新的系统字典详情信息 VO对象集合
    * @return 更新后的系统字典详情信息 VO对象集合
    */
    List<SysDictItemVo> modifys(List<SysDictItemVo> vos);

    /**
     * 根据字典类型编码查出对应的所有字典条目的数据集合
     * @param codes
     * @return
     */
    List<DictModel> queryManyDictByDictCodes(List<String> codes);


    /**
     * 通过查询指定table的 text code key 获取字典值
     * 查询字典表的数据 支持设置过滤条件、设置存储值作为in查询条件
     * @param table 表名称 （或表名称 + " where k = 'v'"）
     * @param text 名称字段
     * @param code 码字段
     * @param keys 码名映射中“码”的值集合 支持批量查询
     * @return
     */
    List<DictModel> queryTableDictByKeys(String table, String text, String code, List<String> keys);

}